package com.ruoyi.point.mapper;

import java.util.List;
import com.ruoyi.point.domain.Logistics;
import com.ruoyi.point.domain.ExchangeOrder;

/**
 * 物流信息Mapper接口
 * 
 * @author hy
 * @date 2025-08-12
 */
public interface LogisticsMapper 
{
    /**
     * 查询物流信息
     * 
     * @param id 物流信息主键
     * @return 物流信息
     */
    public Logistics selectLogisticsById(Integer id);

    /**
     * 查询物流信息列表
     * 
     * @param logistics 物流信息
     * @return 物流信息集合
     */
    public List<Logistics> selectLogisticsList(Logistics logistics);

    /**
     * 新增物流信息
     * 
     * @param logistics 物流信息
     * @return 结果
     */
    public int insertLogistics(Logistics logistics);

    /**
     * 修改物流信息
     * 
     * @param logistics 物流信息
     * @return 结果
     */
    public int updateLogistics(Logistics logistics);

    /**
     * 删除物流信息
     * 
     * @param id 物流信息主键
     * @return 结果
     */
    public int deleteLogisticsById(Integer id);

    /**
     * 批量删除物流信息
     * 
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteLogisticsByIds(Integer[] ids);

    /**
     * 查询物流信息列表（多表联查，包含订单信息）
     * 
     * @param logistics 查询条件
     * @return 物流信息集合
     */
    public List<Logistics> selectLogisticsListWithOrder(Logistics logistics);

    /**
     * 根据订单ID查询物流信息（多表联查）
     * 
     * @param orderId 订单ID
     * @return 物流信息集合
     */
    public List<Logistics> selectLogisticsByOrderId(String orderId);

    /**
     * 根据用户ID查询物流信息（多表联查）
     * 
     * @param userId 用户ID
     * @return 物流信息集合
     */
    public List<Logistics> selectLogisticsByUserId(Integer userId);

    /**
     * 根据地址ID查询物流信息（多表联查）
     * 
     * @param addressId 地址ID
     * @return 物流信息集合
     */
    public List<Logistics> selectLogisticsByAddressId(Integer addressId);

    /**
     * 查询所有处理中的订单（用于物流管理）
     * 
     * @return 处理中订单列表
     */
    public List<ExchangeOrder> selectProcessingOrdersForLogistics();
}
